Developer Documentation

QuickTime 4 API Documentation

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Actions for Sprite Tracks

A sprite created at runtime is associated with the current sprite key frame. It will remain alive until a new sprite key frame is loaded. It has all the regular properties of a sprite including the new sprite property kSpritePropertyActionHandlingSpriteID which delegates its handling of wired events to another sprite. In QuickTime 4, runtime sprites cannot have there own unique event handling atoms.

Constant descriptions

kActionSpriteTrackNewSprite
Supported flags: none Param1: [QTAtomID spriteID ] Param2: [ short imageIndex ] Param3: [ MatrixRecord matrix ] Param4: [ short visible ] Param5: [ short layer ] Param6: [ ModifierTrackGraphicsModeRecord graphicsMode] Param7: [ QTAtomID actionHandlingSpriteID ] Dynamically creates a new sprite with the properties specified by the parameters. You may pass zero for the spriteID and a unique ID will be assigned.

kActionSpriteTrackDisposeSprite
Supported flags: none Param1: [QTAtomID spriteID] Disposes the sprite with the specified ID. Note that this disposes the sprite object in memory, it does not dispose the sprite from the media. If you dispose a sprite that exists in a sprite track's media, it will be created again the next time the key frame sample is loaded.

kActionSpriteTrackSetVariableToString
Supported flags: none Param1: [QTAtomID variableID] Param2: [Cstring theString] Sets the value of the sprite track variable specified by variableID to theString . This replaces the previous value of the variable. Variables may be either a string or a floating-point number.

kActionSpriteTrackConcatVariables
Supported flags: none Param1: [QTAtomID firstVariableID] Param2: [QTAtomID secondVariableID] Param3: [QTAtomID resultVariableID] Concatenates the string in the sprite track variable specified by secondVariableID to the end of the string in firstVariableID and places the result in the variable resultVariableID . Uninitialized string variables are the empty string. Variables containing floating-point numbers are coerced to strings.

kActionSpriteTrackSetVariableToMovieURL
Supported flags: none Param1: [QTAtomID variableID] Param2: <[MovieTargetAtoms externalMovie]> Sets the value of a sprite track variable to a string containing the URL of the movie that contains the sprite track, or optionally the URL of an external movie if the second parameter is used.


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |